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Introduc t ion 



jraimiilng for a digital computer is writing the precise se- 
quence of instructions and data vjhich is required to perform a given 
computation* The purpose of an assembly program la to facilitate 
programming by translating a source language, uhich is convenient 
for the programmer to use, into a numerical representation or object 
program, x-ihich is convenient for the computer hardware to deal with, 
A symbolic assembly program such as MIDAS permits the programmer to 
use mnemonic symbols to represent instructions, locations, and other 
quantities with which he may be working. The use of symbolic labels 
or address tags- permits the programmer to refer to instructions or 
data without actually knowing or caring what specific location in 
^- the computer memory they may occupy, 

MIDAS is a two pass assembler; that is, it normally processes 
the source program twice* During the first pass, it enters all sym- 
bols definitions encountered into its symbol table, which it then 
uses on Pass 2 to generate the complete object program,, 

The MIDAS ^S ource Language, 

A program consists of a sequence of numbers in memory which 
may be instructions, data, or both* We shall refer to these numbers 
as words without specifying whether they are instructions or not. A 
word is denoted in the source program bj one or more syllables sepa- 
rated by suitable combining operators, and terminated by a tab or car- 
riage return, A syllable may be defined as being the smallest ele~ 
Q ment of the programming language which has a numerical or operational 

value. The following are some different types of syllables: 
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1* Integers o An integer is a string of digits, which will 
be interpreted as an octal or decimal number* 

2o Symbols « A symbol is a string of alphanumeric characters 
(lower case numerals and letters, and upper case let- 
ters except U, I, S, and X) containing at least one 
letter * The first six characters of a symbol are used 
to identify it if it is more than six characters long* 

Syllables may be combined with the following operators: 

+ or space means addition, modulo 2-1 (one J s complement). 

- means addition of the one's complements 

U means logical union (inclusive or)., 

I means logical intersection (logical and ) , 

S means logical disjunction (exclusive or)* 

X means Integer multiplication* 

A symbolic expression is one syllable, or more than one syllable com- 
bined with these operators „ We shall refer to *, -, and space as ad- 
ditive operators, and U, X, S, and X as product operators « 

Operations are performed from left to right, except all prod- 
uct operations are performed before additive operations «, It is not 
admissible to precede or follow a product operator with any other 
operator* In a string of consecutive additive operators, the last 
one seen applies « 

The following examples of symbolic expressions on the left 
have the value listed on the right* (All numbers in this report 
are octal unless followed by a decimal point "."•) 
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Symbols are defined In the following ways: 

1* Ad address tags. A eoEHia following a symbolic expres- 
sion denotes an address tan:. If the tag is a single,, 
undefined symbol, it uill be defined with numerical 
value equal to the present value of the location 
counter. If the tag is any other defined symbolic 
expression, it will have its value compered uith the 
present value of the location counter, and an error 
coxmiient (mdt) will be made in. the event of £ disagree- 
ment* If the tag is any other symbolic expression 
which is undefined when encountered on Pass 2 } an er- 
ror comment is made ( ust ). Use of a defined symbol as 
an address tag cannot change the value of the symbol, 

2* By parameter assignments* A symbol may be assigned a 
numerical value by the use of a parameter assignment . 
The form 

symbol=e3cpzy 

where symbol is any legal symbol and exnr is any sym- 
bolic expression terminated by a tab or carriage return* 
defines symbol as having the numerical value of exD*\ 
Parameter assignments may be used to set table sizes, 
define new operation codes, or for other purposes • Thus 

cle^eailtoo^ 

defines cle as 700201, itfhich, as an operate instruction, 
would clear the AC. S LR, and XH. 

3o As variables* The appearance of a letter or letters in 
upper case in any legal, undefined symbol* at any ap-- 



. 5 . 



pearanee of that symbol, defines that symbol as a 
variable* For each ouch symbol defined, one registe: 
is allocated in a region of storage reserved by the 
next appearance of the pseudo-instruction variables «. 
The initial contents of these registers is undefined, 
Tills feature facilitates the reserving of temporary 
storage locations, ExaiQple: 



sto temp 
tsx subr 
Ida Temp 



variables 
Beware: Do NOT try to use upper case letters U, I, S* or X 
to denote a variable 3 

4. As macro instructions v A symbol is defined as a macro- 
instruction name by use of the pseudo-inst ruction de- 
fine. Further discussion of macro instructions will 
be left until later 

5« With e quals or ojdsj^tu A symbol may be defined as pre- 
cisely equivalent to any other symbol by use of the 
pseudo-instruction equals, and ppsgn* The usage is: 

equals anysym^ defsym^ 

or 
opsyn onysym, defsymj 

where the symbol anysym is made logically equivalent 
^° defsym if the latter is defined., Previously defined 
symbols are redefined. Equals and opsvn differ in one 
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respect: oj^syn is effective in Pass 1 only. These 
may be used to define a logical equivalent for any 
other defined symbol* Thus abbreviations may be de- 
fined for pseudo-ins tactions if desired. Note that 
' equals and opsyn are HOT the same as the equals sign 
used in parameter assignments* and are not in general 
interchangeable with it. Equals and ojssyn are used 
to give a symbol a logical or operational, value $ 
while parameter assignments are used to give a symbol 
a numerical value* Beware that if you define synonyms 
for start that either the synonym starts with the let- 
ters s,t,a,r,t or- the word start appears after the use 
of the synonym at the end of the source program tape. 
Although the main processor in MIDAS will recognize 
synonyms for start, the part of the program which reads 
tape will not, and must be fooled into stopping the 
tape reader independently of the rest of the assembly, 

The Loc ation C ounter 

The MIDAS location counter records the assigned location for 
each word in the object program* It is set to 20 at the beginning 
of each pass, and counts upward modulo memory size* The location 
counter may be set to any value by writing 

expr| 

Tills sets the location counter to the value of the symbolic expres- 
sion expr modulo 2 13 c If ex®r contains an undefined symbol, on 
Pass 1 the location becomes i ndefinit e, and the definition of address 
tags is inhibited until the location again becomes definite hj means 

of a defined location assignment. On Pass 2, an undefined symbol 



will result in an error message (uslK The undefined symbol is t.:il:en 
as serOj and tee location remains definite. The pseudo-instruction 
j£S£i§5M§ ma F ^°^ ^e need when the location Id indefinite « 

The value of the location counter may be obtained by usiu& 
the special syllable "." (period )« Examples; 

tze «-K2 com 

tra nonzero trn .-i 

llr foo 

The first example transfers to location nonzero if the AC contains 
any number other than zero, but sero in the AC causes the program to 
skip to the llr instruction* The second example puts the magnitude 
of the contents of the AC into the AC "by transferring back to the com- 
plement instruction until the AC becomes positive* The second in- 
struction is read "trn point minus one * " 

The character ".", when preceded by an integer, denotes that 
the integer is to be considered as decimal regardless of the effect 
of the pseudo-instruction octal or decimal,, "Point" means location 
counter only when it appears as a distinct syllable. Thus, 

add v means add this instruction to AC 
20 * means 20 decimal.. 

The character [, when not preceded by an expression, denotes the be- 
ginning of a comment. Characters following it are ignored until the 
next tab or carriage return* 

Constants 

Constants required by a program will be reserved automatically 
by MIDAS when enclosed in parentheses • Thus, if it is required to 
get the number add, SO, into the accumulator, one can write 

Ida (add 20} 



The word enclosed in parentheses is stored in a block reserved by the 
(_ next appearance of the pseudo-instruction constants » Duplicate con- 
stants are stored only once* Closing parens will be supplied auto- 
matically h^r MID&S if the character following is a word terminator 
(e.g., tab or carriage return )• The constant uord and surrounding 
parens are treated as a single syllable whose value is the address 
of a register containing the constant word*. Constants may be used 
in constants. The following two program fragments are equivalent: 

add (add (20)-llr-(30 add a 

« o 

constants a, add b~llr~c 

b, 20 

c, 30 

The pseudo -instruct ion constants, may not be used where the location 
( is indefinite* 

F lexo Code _Pse udo -Ins true t ions 

Three pseudo -instruct ions are provided to facilitate handling 
flexowriter characters in programs ■. These are: 

1„ character qc , where g is any of the letters 1, m, or r, 
which specifies whether the character c is to be placed 
in the left (bits 0, 3, 6, 9* 12., 15 « ), middle (bits 1, 
b* If 10., 13*,, 16.) or right (bits 2, 5, 8, 11., l4«, 17 . ) 
portion of the word* The pseudo-instruction, with its 
argument, is treated as a single syllable « 

2 ° f lexo abc , where a, b, c are any three flexo characters, 
is equivalent to 
( character ra-fcharacter mb+character 1c 



3* tessfc .^Arbi trary.. . string... of cha ract ers « ja , where the arbi™ 
^_. trary string of characters is stored three to a word e, a 

In flexo until the first character a Is encountered a^ain. 
Neither appearance of q is considered part of the string* 
Thus a ®sy ^ e &ny character not appearing in the string. 
The following ezanples demonstrate their usage. 

character rf is equivalent to iiOiO 

character inn " " w 2220 00 

flexo thi u " " i00Q00+202000+Q04400=3G640i 

text .this. f! " " (306400? 

{.OOlOiOj 

Macro .Inst ructions 

Often certain character sequences appear several times through- 
out a program in almost identical form. The following example illu- 
/~ strates such a repeated sequence „ 

Ida a 
add b 
sto c 
Ida d 
add e 
sto f 

The sequence: 

Ida x 
add y 
sto z 

is the model upon which the repeated sequence is based «, This model 
can be defined as a macro instruction and given a name,. The charac- 
ters x, v, and z are called dxmmjr a rgument s , and are identified as 
such hy being listed immediately following the macro name when the 
macro instruction is defined. Other characters, called arguments, 
(~ are substituted for the dummy arguments each time the model is used. 
The appearance of a macro-instruction name in the source program is 



-10- 

ref erred to as a call« The arguments are listed immediately follow- 
ing the Fjacro name when the macro instruction is called » $hen a 
macro instruction is called, MIDAS reads out the characters which 
form the macro -instruction definition, substitutes the characters of 
the arguments for the dummy arguments, and inserts the resulting 
characters into the source program as if typed there originally • 

TiiQ process of defining a macro is best illustrated with an 
example : 

define write a,b 
tsx wr 

13-. -2 

text faj 

b, terminate 

The pseudo-instruction define, defines the first legal symbol 
following it as a macro name* Next follow dummy arguments as re- 
quired, separated by coismas, terminated by a tab or carriage return. 
Next follows the body of the macro definition. Appearances of dussny 
arguments are marked , and the character string is stored away. Dummy 
arguments are delimited by the following characters: plus* minus , 
space , U, I, S, X, upper case, lower case, tab, carriage return, 
equals, eonsua, bar, colon, and upper case i, 6, and 9* Dummy argu- 
ments raust be legal symbols; any previous definition of dummy argu- 
ment spabois la ignored while in the macro definition* 

A macro call consists of the macro name ? followed if desired 
by a list of arguments separated with commas^ and terminated with a 
tab or carriage return,, The write macro, if called as follows: 

write '.illis gets printed out,^ nextag 

generates the following code: 

tsx wr 
nextag-* -2 

text !*Ms gets printed out, ( 
nexta>:» 
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?Jh±ch, with a suitable text-printing subroutine, might comprise the 
necessary code for printing "This gets printed out*" on the flexo- 
writer. The argument to be printed,, using this format, must not con- 
tain the characters comma, tab, carriage return or bar. Comma, tab, 
or carriage return would end the argument i*hile bar would terminate 
the argument of the text pseudo -instruction. So that comma, tab, and 
carriage return can be used within arguments, the argument quotation 
characters upper case s and 3 are provided. They might be used as 
foliows: 

write e This, of course, has commas *i 

It also has a carriage "o'c-.-r-a < s , ne:-;tag 

All characters within a pair of argument quotes are considered to 
be one argument, and this entire argument, with the quotes removed, 
will be substituted for the dummy argument in the original definition,, 
MIDAS marks the end, of an argument only on seeing comma, tab* or 
carriage return not enclosed within argument quotes. If quotes appear 
within quotes, the outermost pair is deleted* If an outer argument 
quote is immediately preceded by an upper case and immediately fol- 
lowed by a lower case, both case shifts are deleted also* A tab or 
carriage return immediately following a macro name denotes that no 
arguments are read* kxxy other separating character will be the 
first character of the first argument except spaces a space used as 
a separator yjill be deleted and will not be part of the first argu- 
ment* 

The second argument of the write macro is a symbol \shich is 
defined as an address tag each time the macro is called, so a differ- 
end symbol must be supplied at each call of the macro to avoid mul- 
tiply defined tags- MIDAS will supply suitable created,, symbc Is for 
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this purpose, guaranteed to be unique to each call of the mac#o, if 
V_ we write the first line of the definition thusly: 

define write ajb or define write a, jb 

In either case, the vertical bar denotes dutamy symbols following it 
will be supplied from special created symbols if not explicitly sup- 
plied when the macro is called,, Tne created symbols are of the form 
GOGaOi, 000a02,.„. O0Ga09* OQOaQa, etc. The created symbol genera- 
tor is reset to OOOaOj at the beginning of each pas3« The number of 
created symbols may not exceed 33*695* - Note that unsupplied argu- 
ments corresponding to dummy arguments preceding the bar are plugged 
in as empty strings . Supplied arguments corresponding to dummy ar- 
guments following a bar suppress the generation of a corresponding 
created symbol* 
r~ There remains one problem: How do we plant dummy arguments 

in the argument of eft ^ raster r, m, or 1? Of course, the r, m, or 1 
could be part of the supplied argument, but there is another way. 
Write , say: 

define aiacro a 



add (charac r*a {note charac ra does not work as 

jra is not a dummy argument 



The sequence upper case, 1, lower ease is deleted during the macro 
definition, but causes the macro scan to search on each side for 
dummy arguments „ In this case, a is found to be a dummy argument, 
and is treated accordingly. If the upper case 1 is not both pre- 
ceded and followed by case shifts, only the 1 is deleted.. 
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Example : 



defizi3 type x464pq 

Ida (charac r*x464pq 

pno 

terminate 



type f gives Ida (charac rf 

pno 



Hovj may one cause a created symbol to define a variable? 
It will not do to write the dummy argument in upper case, for then 
the created symbol would be in upper case. Since upper case numerals 
are not legal symbol constituents, created symbols must not appear 
in upper case,, The solution is to append a suitable upper case let- 
ter, say z, to the dummy argument* 

Example : 



define 



terminate 



macro fa 
sto aZ 
tax subr 
Ida aZ 



j case shift makes end of 
| dummy argument a 



The variables would then be of the form QOOaOlZ, 0000aQ2Z, etc* 
ighich are perfectly legal and unique variables. 

Created symbols have been introduced to solve the problem of 
address tags within macro definitions, but they may be used in other 
ways also* Seme examples are given in Appendix 2. 

Macro definitions may contain other macro definitions or 
macro calls • Arguments of the macro being called may be used in 
the macros it calls or defines with perfect generality a As an 
example, let us rewrite the write macro so that it inserts a suit- 
able text printing subroutine into the object program at its first 
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call, and then redefines itself so that later occurrences call the 

subroutine. This might be done as follows: 



d, 



define write a 

define write cjd 
tsx wr 

do 

text j c | 
terminate write 

write a a 
tra zisxgwq 

llx 

lax 1 
aux « ~*x 
pnt 
pnt 

prtUixl 
tix Ipkh 

trx i 
zzxgwq, terminate 



wr, 
lpkh. 



| rede fines write when called first time 



{calls new definition 



text printing subr 



Notice that address tags in the text printing subroutine need 
not be created symbols, as the tags appear only at the first call 
°^ write, They must not, of course, conflict with tags used elsewhere 
in the program, and to insure this, created symbols may be used if 
desired. Notice that, in this example, the pseudo-instruction 
t erminate has been supplied with an argument: the name of the macro 
being defined- If terminate is followed by a space, it will expect 
to find this argument, which it will compare with the name of the 
saacro being defined* Unless they agree, an error comment ( tnnd ) will 
"be made. This permits the programmer to be sure that his defines and 
terminates count out correctly. An additional aid in this respect 
is the fact that terminate is undefined outside a macro definition, 

Arguments can, by judicious use of argument quotes (see ex- 
ample below), contain sub-arguments* A pseudo- instruct ion irp 
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( indefinite repeat) permits the analysis of such an argument. The 
pseudo -instruct ion irj> in the macro definition takes one argument , 
namely, the dummy argument corresponding to the argument to he an- 
alyzed* When the macro instruction is called, the characters follow- 
ing the argument of the i rg until the next matching endlrp will be 
inserted once into the program for each sub-argument in the argument 
being analyzed, and the sub-arguments will be substituted for the 
corresponding dummy argument,. Example: 

define sum a,b,c 
Ida a 
irp b 
add b 
endirp 
sto c 
terminate 



sum j,°k,l,m 8 J> W 



gives : 



Ida J 
add k 
add 1 
add m 
sto II 

It is quite permissible to have Irp* a within an irp, analysing 
either the same or different arguments . The pseudo-instruction* Itjd 
an< * endirp are defined only within a macro definition,. If an irp 
analyzes a null string, the characters in the range of the irp will 
be inserted once, and null string will be inserted for the subargument 

The Garbage Collector 

When MIDAS redefines a macro, the space in the macro instruc- 
tion table used by the old definition will be recovered, if necessary, 
by a garbage collector. It is important in a long program to insure 
that unused macro definitions are abandoned, that is, that their names 
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are caused to refer to something else other than the original macro 
definitions. A suitable "some thine else" is the pseudo- instruction 
null, which does absolutely nothing. Thus if a macro called foo has 
been defined, it may be discarded after its last usage tey saying: 

equals foo, null 

which will make the space used hy foo recoverable. The garbage col- 
lector is called whenever the combined macro and symbol tables are 
exhausted. If no space can be recovered, an error comment is made 
( see ). 

Repeat 

The pseudo-instruction repeat expr, anything, where expr is 
a symbolic expression defined on Pass i and aj&d&&& is any string 
of characters terminated by a carriage return, causes anything to be 
inserted into the program a number of times, called the Qojanjb, equals 
to the value of exgr. The anything, called the range of the repeat, 
can be storage words, parameter assignments, macro calls (if not con- 
taining carriage return in an argument), other repea ts, or anything 
else- If repeat is used in the range of a repeat , both re peats will 
end on the same carriage return. Repeat may be used in macros s and 
dummy arguments may appear either in the range or the count of the 
repeat , or both. If the count of a repeat is zero or negative, the 
range of the repeat is ignored. 

Dimension 



C 



The pseudo-instruction dimension may be used to allocate space 
for arrays. The statement 

dimension namel(sizel), name2(size2), . . *^ 
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causes space to be reserved in the variables storage for the array 
(_ names specified. Each name is defined as the location of the first 
of the block of registers of the length specified. The array names 
must not have conflicting definitions elsewhere, and the array sizes 
must be defined at their occurrence on Pass 1. 

Condit ional Assembly 

It is often useful, particularly in Jsacro instructions, to be 
able to test the value of an expression, and to condition part of the 
assembly on the result of this test. For this purpose the pseudo- 
instruction lif and Oif are provided,, Following the pseudo-instruction 
name there is a symbol called a qualifier that determines the type of 
test; and then an argument that is tested according to the qualifier. 
The argument is ended by any of the word terminators tab, carriage 
return, comma, or slash. Ail these terminators except slash do what 

c 

they would have aone had the conditional not "been present; but slash 
only marks the end of the conditional, which is treated as a single 
syllable whose value is one or zero. Examples: 

repeat Oif vp x+1, macro argl,arg2l, 
a«iif vzxl600000 — *f 
sto p-KLif vp-sjX^j 

The value of lif is one if the condition tested for is true, 
and zero otherwise; while the value of Oif is zero if the condition 
tested for is true, and one otherwise. There are at present two 

qualifiers with two corresponding tests: 

vis: If the value of the expression following is positive 
or zero (either plus or minus), the test is true* 

^ vz: If the value of the expression following is zero, 

the test is true* 
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The first example calls the macro if x;>-l„ The second example 
(^ defines a as one if the two high bits of x are both zero; otherwise 

a is defined as zero. The third example generates stojp i£ §. ^ posi- 
tive, and sto p-t-2 if s is negative. It could also be written as: 

sto p+2X0if vpa£ 

Conditionals may be used in or out of macros, but may not con- 
tain other conditionals* 

The Source and Object Programs 

A source program for MIDAS consists of one or more flexo tapes, 
each with a title, a body, and a sta rt pseudo-instruction. The title 
is the first string of characters and is terminated by a carriage re- 
turn. Carriage return and stop codes preceding the title are ignored, 
(~ The body is the storage words, macros., parameter assignments, etc. 
which make up the substance of the program* It may be void. The 
start pseudo-instruction denotes the end of the source program tape* 
It takes one argument, which specifies the first instruction to be 
executed in the object programs. Start must be preceded by a tab or 
carriage return, and followed (after the argument, if supplied) by 
a carriage return. READ THE IAST SENTENCE AGAIN. In spite of all 
warnings, the number of people who omit the carriage return after start 
is amazing*. Therefore, take heed. 

MIDAS will normally punch a binary object program during 
Pass 2 of an assembly* It will contain a title in readable charac- 
ters, consisting of the visible characters in the title except those 
following (and including) an equals sign ft Next will be punched an 
O input routine, which is a loader that reads in the rest of the tape, 
and which is itself read in by the TX-0 read i n mo de, The binary 
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output from the body of the source program is punched in blocks of 
up to 100 registers., The end of the binary tape is denoted by a 
start block , which is produced by the pseudo-instruction start 6 The 
start block may be of two types: 

1* The add start block causes the input routine to stop* 
and pressing Restart transfers to the address specified. 
It is punched by start addi% where addr is a symbolic 
expression whose value specifies the starting address « 
MIDAS adds add to this and punches it on the tape., 

2. The trn start block causes the input routine to transfer 
at cnce to the address specified. In this case the 
argument of start must have the value of add addr where 
addr is the address in queistion, MIBAS adds add (=200000) 
to this, giving trn (-400000) and punches it on the tape* 

The format of the output is subject to considerable control by 
the programmer. The pseudo-instruction noinput suppresses punching 
the input routine* The pseudo-instruction readin suppresses the in- 
put routine and punches in readin mode until the next encountering of 
the pseudo-instruction no input s which resumes punching in input routine 
format. The normal input routine occupies registers 17756-17777, but 
an input routine occupying registers 0-22 will be supplied by the 
pseudo-instruction frontloadln g, which, if used, must be the first 
thing on the English tape (after the title, of course). This pseudo- 
instruction causes the location counter to start at 30 instead of the 
usual 20* 

For fabricating special tape formats or punching start blocks 
(_ without stopping the assembly, the pseudo-instruction word is pro- 
vided * Its argument or arguments, sex>arated by commas and ended by 
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a tab or carriage return, are punched directly on the object program 
tape, and do not affect the location counter- 

The tape formats discussed so far are characterised hy having 
a specific location in core assigned for each word in the object pro- 
gram* MIDAS will also produce relocatable tapes, which, by means of 
a special loader-, may be placed any where in memory. Before using 
this feature, described in the next section, the reader is advised 
to familiarise himself uith Memorandum M-5001-34, which describee the 
relocatable loader and relocatable system. 

Re loca table . .Programming 

The pseudo-instruction relocatable directs MIDAS to assemble 
the object program in relocatable format and sets the location counter- 
to relocatable 0. Address tags will be defined as relocatable symbols 
(relocation count -fi) as long as the location is relocatable. Symbols 
defined by parameter assignment will have a relocation count equal to 
that of the expression to the right of the equal sign except that no 
symbol may have a relocation count exceeding one in magnitude. A lo- 
cation assignment puts tte location to relocatable or absolute accord- 
ing to xirhether the relocation count of the location assignment is 
+1 or 0* Relo catable also suppresses punching an input routine, re- 
placing it with a word trn._l ?Q00 , which, when executed in the readin 
mode, transfers control to the entry of the BRS Loader, Storage 
words in relocatable mode may have relocation +1, -1, or 0; words in 
absolute mode may have relocation only. 

The pseudo-instruction exit is used to define symbols which 
are external to the program being assembled. The usage is 

exit si, s2, S3* * * * jj2» 
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which enters the symbols s±* s2, . . . in the transfer vector and de- 
v^ fines them as the addresses they occupy there.. Only the first three 
characters of these symbols are significant to the relocatable loader, 
These symbols must not be defined with a conflicting definition else- 
where or an error message (mdx) will be produced* 

The pseudo-instruction entry is used to denote points in the 
program to which external programs may transfer control. The usage 
is: 

entry si, s2, s3, „ . -? 

where the symbols si, s2, * , „ must be defined as address tags else- 
where In the program c The symbols so declared are entered in the 
program card* Again, only the first three characters of such symbols 
are significant to the relocatable loader. For a program with both 

r~ primary and secondary entries, the pseudo-instruction entry is used 
twice consecutively, first listing the primary and then the secondary 
entries. To the extent that the pseudo-instructions relocatable, 
entry ,, and exit are used, they must be used in that order , and no 
storage words may intervene between thenu A program with no entry 
specified is a main program, and the pseudo-instruction ex it wiD.l 
cause a program card to be punched with a name of 4-0, as required by 
the BBS loader. If neither entry nor exit is used, no program card 
will be provided. Since any program to be loaded by the HRS Loader 
must have a program card, it has been made possible to get a program 
card with a main program entry by using the pseudo- instruct ion entry 
with no arguments. The maximum number of arguments of entry is 37; 
there is no limit on the number of arguments of exit. 

( In relocatable programs, the pseudo-instruction noinput will sup- 

press punching the word trn 17000. at the head of the object program tape 
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Format 

r 

^-~ MIDAS has few requirements on format. The rises? should be aisare 
of the following: 

1. Carriage returns and tabs are equivalent except in the 
title, in the range of a repeat, and after start « Extra 
tabs or carriage returns are ignored , 

2„ Backspace, the upper case numerals except ±, 6, and 9, 
and the unused characters of the flexo code, including 
blank tape with only the seventh hole punched, are ille- 
gal except in arguments of flexo code pseudo-instructions, 

3* Stop codes and color shifts are ignored except in argu- 
ments of flexo code pseudo-instructions. Upper case 
X, 6, and 9 are similarly ignored when not in macro calls 
^ or definitions • 

4. Deletes are always ignored u 

Many programmers have found that adherence to a fairly rigid 
format is of help in writing and correcting programs. The following 
suggestions have heen found useful in this respect: 

i* Place address tags at the left margin, and run instruc- 
tions vertically down the page indented one tab stop from 
the left margin . 

2, Surround address tags with color shifts. It looks nice* 

3* Use only a single carriage return between instructions, 
except where there is a logical break in the flox^ of the 
r- , s program. Then put in an extra carriage return « 

4. Forget that you ever learned to count higher than three; 
let iyjlDAS count for you» Do not say §t£L~sj£Lf use an ad- 



'""'i'D 



C 



dress tag. This will save grief -when corrections are 
required* 

5. Organise the program by pages, separating each page of 
flexo tape with a stop code and some tape feed* Let the 
page boundaries coincide with logical divisions of the 
program if possible. Fixing one bad page and splicing 
in a new one takes about as much time as reproducing two 
pages of program, so learn to splice tape. 

6* Have the typescript handy when assembling or debugging 
a program, and note corrections in pencil thereon as soon 
as you find them* 
Performlnry |j an iii J-S i semb3.y 

First read in MIDAS. Turn on the on-line flexoxcriter and 
press Start Read* Set the THR to tra 20 and the TAC to 0, Load 
the first source tape into the reader and press Restart B MIDAS will 
read the tape in sections of about two pages each, and will stop 
shortly after reading start at the end of the tape* To process addi- 
tional tapes after the first, press Test » Now begin Pass 2 by loading 
the first tape and pressing Restart , For additional tapes, press 
Test*. At the end of Pass 2, press Restart again to secure a start 
block* Tapes should be processed in the same order on both passes . 

The normal operation of MIDAS say be summarised by the follow- 
ing table: 

Action on Restart 



Condition 


AG 


LR 


MBR 


MIDAS or symbol 
punch read in 





-0 


-0 


End of tape,, Pass 


i 








End of tape, Pass 


2 








After start block 





-0 


-0 


Error stop 


-0 


~0 


-0 



Begin Pass 1 
Begin Pass 2 
Punch start block 
Restore, begin 



Action on Test 

Begin Pass 2 
Continue Pass i 
Continue Pass 2 

Begin Pass i 



Pass i 

Continue, suppress Continue Pass 

punching 



c 
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The normal sequence of operations above can be modified by 
use of the TAC* Whenever Test is pressed, bit of the TAG is ex- 
amined. If it is aero, the normal sequence is followed; if it is 1, 
the next 6 bits of the TAG are examined « These control: 

Bit 1 Pass 1 if 0, pass 2 if 1„ 

2 Begin pass if 0, continue pass if 1, 

3 If 1, punch if pass 2; if 0, do not punch* 

4 If 1, punch input routine if punching; if 0, no input* 

5 If ly punch title if punching; if 0, no title . 

6 If 1, restore symbol table to Initial symbols and pseudo- 
Instructions. 

Error J3t ops 

MIDAS will complain about various ambiguities and error con- 
ditions found in source programs « Some of these have already been 
mentioned* An error listing has the following format: 

Column i: A three letter code describing the type of error . 
A number following is the depth of macro calls • 

2: The octal location in the object program. The 
symbol r means relocation.. 

3: The symbolic location, in terms of the last ad- 
dress tag seen* 
4: The last pseudo- or macro-instruction name seen« 
5: The offending symbol, if a symbol was in error, 

MIDAS will ignore most errors (with exceptions noted below) 
and will continue the assembly if Rest art or Test (with TAG 0=0) is 
pressed; the two are equivalent except Restart will discontinue punch- 
ing on Pass 2 if it was in progress. Turning up TAC 17 is equivalent 
to pressing Restart after an error stop* This bit is independent of 
the rest of the TAC. 
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The error conditions are: 



uj 



ich 

ile 
ilx 
ir- 



w: 



d 

P 
c 
s 
e 
r 
t 

1: 



mnd; 

mdt: 
mdx: 

mdv : 



In general, undefined symbol.. Undefined symbols 
are evaluated as Go The third letter tells where 
it was found: 

In a storage word or argument of pseudo-instruction 
word . 

In a storage word generated by a macro call. 

In the size of a djiaensipn array. 

In a parameter assignment 9 

In a constant c 

In the argument of start. 

In an argument of entry; «, 

In the count of a repeat. 



In an address tag of more than one syllable c This 
will frequently be the result of an undefined 
macro instruction* 

In an argument of Oif or iif 

Illegal character o The bad character is ignored. 

Illegal formate Some character or characters were 
used in an improper manner* Characters are ignored 
to next tab or carriage return. 



Illegal entry . Argument of ent 
will be ignored • 



Illegal exit 
be ignored * 



is improper and 
Argument of exit is improper and will 



Illegal relocation* The relocation is taken as o 
The third letter identifies where it was found, and 
will be the same as listed under undefined symbols 
(above ) 6 

BSacro name disagrees „ The argument of terfflinate 
disagrees with the name of the macro being defined * 
First name is used. 

Multiply defined tag* Original definition retained. 

Multiply defined exit. An argument of exit is pre- 
viously defined with a conflicting value* Original 
definition x*»etained„ 

Multiply defined variable . A symbol containing an 
upper case letter is previously defined as other than 
a variable* Original definition retained- 
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mdd: Multiply defined dimension,. An array name in a 

dimension statement has a conflicting definition,, 
Original definition retained.. 

ipa: Improper parameter assignment* The expression to 

the left of an equal sign is improper. The assign- 
ment is ignored t 

see: Storage capacity exceeded „ Assembly cannot continue, 

tmc: Too many constants: the pseudo-instruction constants 
used more than 10* times in one program* 

tmp: Too many parameters: the storage reserved for macro 
instruction arguments has been exceeded. 

tme: Too many entries* Maximum number of arguments of an 
entry pseudo-instruction is 37 octal* 

tmv: Too many variables ♦ The pseudo-instruction variables 
has been used more than 8 times in one program. 
Assembly cannot continue* 

eld: Constants location disagrees. The pseudo-instruction 
constants has appeared on Pass 2 in a different lo- 
cation from that found on Pass 1, meaning all the 
constants syllables have been assigned the wrong 
value- Assembly cannot continue. 

vld: Variables location disagrees* The pseudo-instruction 
variables, has appeared on Pass 2 in a different lo- 
cation from that found on Pass 1. The condition is 
ignored, 

iae: Internal assembler error* MIDAS has found that it 
has made a mistake in assembling the program- De- 
liver the error message and a copy and listing of 
the source program to a member of the TX-0 staff so 
that the trouble may be found* Assembly cannot con- 
tinue* The octal location given is the location in 
MIDAS where the error was found. 

Trqubleelaooiin^ 

The checking features built into MIDAS will detect simple 
errors like forgotten tags very simply. Attempting to debug complex 
macro definitions from error messages and binary output is a much 
more difficult proposition * Special aids have been provided to sim- 
plify this* 



^ 1* The pseudo-Instructions grlnt and pjrjLntx take an argu- 

ment exactly like text, which MIDAS v;ill print out on- 
line* during the assembly process. J?£i£itx Points just 
the argument and a following carriage return, while 
print precedes this with the first three columns of 
an error listing* with the "error" code gnt« The argu- 
ment of print or printx may contain dummy s;pabols if 
used in a macro definition, 

2 8 Bit ±6 of TAG when on, causes MIDAS to print out on- 
line every character it processes, including all macro 
expansions- This permits the programmer to let MIDAS 
do '^he bookkeeping when testing a complicated macro* 

C_ Symbol ...Punch ,_ .and Symbo 1 Print 

A record of symbol definitions may be printed out by reading 
In MIDAS SYMBOL PRINT. An alphabetic or numeric order listing may 
be secured hj reading in the appropriate tapes, 

A punched record of symbol and/or macro instruction defini- 
tions may be obtained hj use of MIDAS SYMBOL PUNCH .' When SYMBOL 
PUNCH Is read In, it will feed some blank tape and listen for a 
title „ Type a title on the typewriter. To obtain both symbol and 
macro-instruction definitions, terminate the title with a carriage 
return • For symbols only, terminate with a tab, and then type "s" 
followed by a carriage return. For macro definitions only, termi- 
nate the title uith a tab, followed by "m" and a carriage return* 
C The symbol punch so obtained may be used with DOCTOR for symbolic 

debugging, or read into MIDAS at a later time for assembling patches 
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or the like, Vilion a symbol punch Is read into MIDAS, TAC 6 is 
(_ examined „ If off,, the symbols from the sumbol punch are merged 
with any existing symbol table * If on, the symbol table is re- 
stored to the initial vocabulary before merging the symbol punch. 
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Appendix 1. MIDAS Initial Vocabulary 
Part 1, Symbols 



add-200000 
ado«06O000 
adx»22O0Q0 
alc~640260 
all«640230 
alo~640220 
alr»640200 
alx«640031 
amzw6 40050 
ana«740027 
anl«640207 
ano»7 2 *-G207 
arx»64o6oi 
aux»260000 
axc**64Q06± 
axo«640021 
axr~640001 
bsr~6o4000 
cal-700200 
cax*=700001 
cla«700000 
clc~70004o 
cll-631000 
clr~632000 
com«600Q40 
cpf«607000 
cpy=*620Q00 
cry«6000l2 
cyl-640030 
cyr*600600 
dis«622000 
dso~662020 
hlt«63O000 
iad*640232 
ial*740222 



lxl-600303 
lac«700022 
lad-600032 
lal*700012 
lar=700622 
lax»*360000 
laz«700072 
lcc«700062 
lcd«600072 
Ida^OQOO 
ldx~24O000 
llr«300000 
llx«320000 
lpd~600022 
lro«600200 
lxr«600003 
opr*»600000 

ora«7^0025 
orl«640205 

oro**740205 
p6b-» 766020 
p6h=626600 
p6o-666020 
p6s«726000 
p7h«627600 
p7o-667020 
pen=603000 
pnc~664060 
pno«664020 
pnt=6246Q0 
prt«6240Q0 
ric~721000 
rlr«72l600 
r3c«723000 
rax«64O203 



rds«604004 

rew**6040±0 

rpf«706020 

rtb«6o4004 

rtd~604024 

rxa«700322 

shr**600400 

slr»!00000 

slx~120000 

spf*647000 

sto~0 

stx**020000 

3 tz« 140000 

sxa»040000 

tac^701000 

tbr«702020 

tix«460000 

tlv*5^0000 

tpl«560000 

tra= s 500000 

tm=*4Q0000 

trx«520000 

tsx= 440000 

typ-625000 

tze«420000 

wrs~6040l4 

wtb=6040l4 

wtd=604034 

xac«700120 

xad«600!30 

xal«700110 

xec~700l60 

xcd»600170 

xlr«600300 

xro=600001 
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character 


APS^?X_I--.;4II)AS INITIAL VOCABULARY 
Part 2 — Pseudo-Instructions 


c 


Inserts numerical value of a flexo character. 



constants 

decimal 
define 
dimen0ion 
endirp 
entry- 
equals 
exit 

flexo 

front loading 

irp 

noinput 
null 
octal 
opsyn 

print 

printx 
readin 
relocatable 
repeat 

start 



Denotes location of stored constants words. 

Interpret Integers as decimal numbers. 

Define macro-instructions* 

Allocates space for arrays. 

Ends indefinite repeat* 

In relocatable programs, puts symbol definitions 
into program card for use by BBS loader. 

Defines symbol as operationally equivalent to 
another symbol . 

In relocatable programs, names subroutines to be 
called by entering names in transfer vector. 

Inserts numerical value for three flexo characters 

Calls for front input routine* 

Indefinite repeat* Analyses macro-instruction 
argument as series of subarguments • 

Suppresses input routine, leaves "readin" status* 

No- operation, ignored. 

Interpret Integers as octal numbers.. 

Defines symbol; same as equals but effective 
on Pass 1 only* 

Generates symbolic location printout and prints 
comment during assembly* 

Prints comment during assembly • 

Punch in readin mode format* 

Punch in relocatable foimato 

Repeats character string. 

Denotes end of program and specifies (in absolute 
program) starting address. 
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terminate 
text 

variables 
word 

Oif 
lif 



Ends macro definition,, 
Inserts words of flexo characters. 
Reserves space for arrays and variables. 
Punches word on object program tape* 

Has value if condition following is true* 
I otherwise* 

Has value i If condition following Is true, 
otherwise. 
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